Inside Macintosh: QuickTime /

Chapter 3 - Image Compression Manager / Image Compression Manager Reference

Image Compression Manager Functions / Getting Information About Compressor Components

GetCodecInfo

The GetCodecInfo function returns information about a single compressor component.

pascal OSErr GetCodecInfo (CodecInfo *info, CodecType cType,
                            CodecComponent codec);

info

Contains a pointer to a compressor information structure. The GetCodecInfo function returns the detailed information about the appropriate compressor component into this structure.

cType

Specifies a compressor type. You must set this parameter to a
valid compressor type (see Table 3-3 on page 3-59 for a list of the available compressor types).

codec

Specifies a compressor identifier. Set this parameter to the
component identifier of the specific compressor for the request.
The component identifier is available in the compressor name list structure returned by the GetCodecNameList function (described on page 3-57).

If you want information about any compressor of the type specified by the cType parameter, set codec to 0. The Image Compression Manager then returns information about the first compressor it finds of the type you have specified.

DESCRIPTION

Your application may retrieve information about a specific compressor or about a compressor of a specific type. If you request information about a type of compressor, the Image Compression Manager returns information about the first compressor it finds of that type. The Image Compression Manager returns the detailed compressor information in a compressor information structure (see "The Compressor Information Structure," which begins on page 3-47, for details).

RESULT CODES

noErr	0	No error
noCodecErr	-8961	The Image Compression Manager could not find the specified compressor

Component Manager errors
Memory Manager errors